package com.td.module.farmer.service.consultation;

import com.td.framework.common.pojo.PageResult;
import com.td.module.farmer.controller.admin.consultation.vo.ConsultationCreateReqVO;
import com.td.module.farmer.controller.admin.consultation.vo.ConsultationExportReqVO;
import com.td.module.farmer.controller.admin.consultation.vo.ConsultationPageReqVO;
import com.td.module.farmer.controller.admin.consultation.vo.ConsultationUpdateReqVO;
import com.td.module.farmer.dal.dataobject.consultation.ConsultationDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;

/**
 * 农事咨询 Service 接口
 *
 * @author 王翔翔
 */
public interface ConsultationService {

    /**
     * 创建农事咨询
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createConsultation(@Valid ConsultationCreateReqVO createReqVO);

    /**
     * 更新农事咨询
     *
     * @param updateReqVO 更新信息
     */
    void updateConsultation(@Valid ConsultationUpdateReqVO updateReqVO);

    /**
     * 删除农事咨询
     *
     * @param id 编号
     */
    void deleteConsultation(Long id);

    /**
     * 获得农事咨询
     *
     * @param id 编号
     * @return 农事咨询
     */
    ConsultationDO getConsultation(Long id);

    /**
     * 获得农事咨询列表
     *
     * @param ids 编号
     * @return 农事咨询列表
     */
    List<ConsultationDO> getConsultationList(Collection<Long> ids);

    /**
     * 获得农事咨询分页
     *
     * @param pageReqVO 分页查询
     * @return 农事咨询分页
     */
    PageResult<ConsultationDO> getConsultationPage(ConsultationPageReqVO pageReqVO);

    /**
     * 获得农事咨询列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 农事咨询列表
     */
    List<ConsultationDO> getConsultationList(ConsultationExportReqVO exportReqVO);

}
